home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / guis / gadutil / docs / autodocs / 16.gu_createlocmenua < prev    next >
Text File  |  1996-07-16  |  2KB  |  52 lines
  1. gadutil.library/GU_CreateLocMenuA           gadutil.library/GU_CreateLocMenuA
  2.  
  3.    NAME
  4.     GU_CreateLocMenuA -- Create a menu with localized items.
  5.  
  6.    SYNOPSIS
  7.     menu = GU_CreateLocMenuA(newmenu, gad_info, createtags, layouttags)
  8.     D0                       A0       A1        A2             A3
  9.  
  10.     struct Menu *GU_GetLocaleStr(struct NewMenu *, APTR,
  11.                 struct TagItem *, struct TagItem *);
  12.  
  13.    FUNCTION
  14.     Create and layout a localized menu. This function replaces both
  15.     the gadtools/CreateMenusA and gadtools/LayoutMenusA functions. See
  16.     those functions for a more in-depth description of this function.
  17.  
  18.    INPUTS
  19.     newmenu - pointer to an array of initialized struct NewMenus. This
  20.           differs from the GadTools function in that, instead of
  21.           giving pointers to strings in the nm_Label and nm_CommKey
  22.           fields of the structure, you should put a string ID in the
  23.           nm_Label field of the structure. The string must be in the
  24.           format "A\x00About...". The nm_CommKey field should be left
  25.           empty.  ^^^^^^
  26.               |    |
  27.               |    |- nm_Label field for the NewMenu structure
  28.               |
  29.               |- nm_CommKey replacement. If no keyboard shortcut,
  30.                     this field MUST CONTAIN A SPACE CHAR.
  31.                     The \x00 is a NULL character.
  32.  
  33.     gad_info - the value returned from GU_LayoutGadgetsA()
  34.  
  35.     createtags - tags for the "CreateMenusA" part of this routine. All
  36.              gadtools tags are supported (directly passed to GT).
  37.  
  38.     layouttags - tags for the "LayoutMenusA" part of this routine. All
  39.              gadtools tags are supported (directly passed to GT).
  40.  
  41.    TAGS
  42.     See the gadtools functions CreateMenusA() and LayoutMenusA().
  43.  
  44.    RESULT
  45.     menu - pointer to the resulting initialized and laid out menu structure,
  46.            ready to pass to the intuition function SetMenuStrip(), or NULL for
  47.            failure.
  48.  
  49.    SEE ALSO
  50.     GU_FreeMenus(), gadtools/CreateMenusA(), gadtools/LayoutMenusA(),
  51.     gadtools/FreeMenus()
  52.